home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / win / ew201a.zip / READ.ME < prev    next >
Text File  |  1994-12-16  |  16KB  |  437 lines

  1.  
  2.  
  3.              E! for Windows - Version 2.0
  4.          (copyright MainSoft sarl 1992, 1994)
  5.  
  6.                 release 2.01
  7.              ____________________________
  8.  
  9.  
  10.      ********************************************************
  11.      *         ATTENTION USERS OF E! for Windows 1.xx:        *
  12.      * PLEASE READ SECTION #8 BEFORE PROCEEDING. THANK YOU. *
  13.      ********************************************************
  14.  
  15. This package contains a fully functional copy of E! for Windows, a
  16. text editor primarily designed for programmers and that will be also
  17. a great help for any Microsoft Windows (tm) user who has to deal
  18. with text files.
  19.  
  20. E! for Windows is a very powerful product that has a very large
  21. number of features. We hope that you'll be as much excited about
  22. this new version as we are.
  23.  
  24. E! is distributed as a User Supported Software (shareware). This
  25. means that it is no free or Public Domain software but that you may
  26. give it a try before purchasing it. Please read the licence
  27. agreement contained in LICENCE.TXT.
  28.  
  29. If you use this software regularly, you have to pay the registration
  30. fee otherwise you have to stop using E! after the 60-day trial
  31. period and to uninstall it. Registered users will receive a printed
  32. documentation, the E! for Windows API documentation and will benefit
  33. from a FAX hot-line. The API is undocumented in the unregistered
  34. version although sample Extension DLLs are provided. Registered
  35. users will also receive a registration code allowing to get rid of
  36. the reminder dialog box and to disable the CRC verification.
  37.  
  38. As mentioned above, the API Documentation is reserved to registered
  39. users. However, not having this documentation will not prevent you
  40. from using Extension DLLs written by registered programmers or
  41. distributed by us.
  42.  
  43. Technical questions about E! may be sent to the following Compuserve
  44. userid:
  45.  
  46.    Patrick Philippot, MainSoft (the author) : 72561,3532
  47.  
  48.              OR
  49.  
  50. uploaded to the CIS IBMAPP LIB 1 or CIS WINSHARE LIB 2 fora which a
  51. the only fora that we scan daily for questions about E!.
  52.  
  53.              OR
  54.  
  55. faxed to MainSoft sarl, France:
  56.  
  57.    +33 1 69 40 94 85
  58.  
  59. Questions related to distribution and registration should be faxed
  60. to the following number in Karlsruhe, Germany:
  61.  
  62.    +49 721 37 38 42
  63.  
  64. Registration information is contained in the file ORDER.FRM.
  65.  
  66. Have fun using E!.
  67.  
  68.  
  69. 1. INSTALLING E! FOR WINDOWS
  70. ____________________________
  71.  
  72.  
  73. WARNING!!
  74.  
  75. ****************************************************************************
  76.  
  77. If you have downloaded E! installation as a ZIP file, please be sure to unpack
  78. it using the -d option (PKUNZIP -d). Otherwise, the required subdirectories
  79. will not be created and installation will fail.
  80.  
  81. E! for Windows should always be installed from an installation diskette. The
  82. installation program does some initial setup and you may run into trouble if
  83. you merely copy the unarchived files to your disk. We do not support versions
  84. not installed from an original, unmodified installation diskette.
  85.  
  86. If you give the program to others, please give an unmodified installation
  87. diskette (as described below). You may not give away a registered copy of E!
  88. for Windows or a copy of the API documentation.
  89.  
  90. ****************************************************************************
  91.  
  92.  
  93. Installation Requirements:
  94.  
  95.       - A system running Windows 3.1 or a later version
  96.     (E! also runs in the WIN-OS/2 environment)
  97.       - At least 4 MB RAM
  98.       - At least 2.5 MB free hard disk space
  99.       - A 640x480 display adapter (not recommended) or better
  100.       - A color (recommended) or monochrome monitor
  101.  
  102. In order to make the distribution package as small as possible, it
  103. is assumed that all DLLs specific to Windows 3.1 and especially
  104. VER.DLL and SHELL.DLL are present on your system and reside in a
  105. directory declared in the PATH statement of your AUTOEXEC.BAT.
  106.  
  107. The installation program will copy CTL3DV2.DLL (a Microsoft DLL) to
  108. your \WINDOWS\SYSTEM directory or to the directory of your system
  109. where it's already installed unless the installed version is newer
  110. than the one we distribute. If, when launching E!, you get a message
  111. complaining that CTL3DV2.DLL is not correctly installed, this means
  112. that there are multiple copies of CTL3DV2.DLL on your disk. This DLL
  113. doesn't accept multiple copies. You should have only one copy of
  114. this DLL, either in the \WINDOWS directory or in the \WINDOWS\SYSTEM
  115. directory.
  116.  
  117. Please copy all the files in this archive to a single diskette (1,2
  118. MB or 1,44 MB format) and keep the sub-directory structure
  119. unmodified (you can use xcopy /e /s or you can run EWARC2.EXE from
  120. the diskette directly - however, the unarchived files cannot reside
  121. on the same diskette as EWARC2.EXE).
  122.  
  123. To install, launch Windows (version 3.1 is required), enter
  124. "a:install" at the File|Run prompt of the Program Manager and follow
  125. the instructions.
  126.  
  127. Normally, the installation program will create a new group for E!.
  128. However, this operation may fail if you are running Norton Desktop
  129. for Windows. NDW has a bug and doesn't emulate the Program Manager
  130. interface correctly. We use a work-around to circumvent this problem
  131. but it may not work on your system.
  132.  
  133. You'll be asked whether you want the installation program to add E!
  134. related data to the Registration Database (REG.DAT). If you click Ok,
  135. associations will be created for the following extensions:
  136.  
  137.     .c .h .cpp .hpp .pas .inc .txt .asm .prg
  138.  
  139. Once this have been done, the Print and Edit commands of the File
  140. Manager will call ew.exe if you have selected a file with one of
  141. these extensions.
  142.  
  143. If you skip this step, you'll be able to add the same information
  144. to REG.DAT later by running the following command:
  145.  
  146.     regedit /s x:\ew\ew.reg
  147.  
  148. EW.REG will be created in any case. It's an ASCII file, so you can
  149. modify it if you want before running the above command. EW.REG is
  150. not a part of the distribution disk. It is created dynamically to
  151. take the directory path were you actually installed E! into account.
  152.  
  153. Once E! for Windows has been installed, please read the documentation
  154. (EW.WRI) at least once (even rapidly). This will give you a good feeling
  155. about the fundamentals of E!. We have tried to make this documentation as
  156. complete and as short as possible. If you decide to print EW.WRI, please
  157. note that it has been paginated for the A4 format.
  158.  
  159. INSTALLING E! IN THE WINDOWS FILE MANAGER
  160.  
  161. Please read EWFEXT.C to learn how to install a File Manager Extension
  162. DLL supporting E!. This process applies to any Windows shell emulating
  163. the File Manager behavior (e.g. Norton Desktop for Windows).
  164.  
  165. RETRIEVING INDIVIDUAL FILES FROM THE INSTALLATION DISKETTE:
  166.  
  167. Almost all files in this package are compressed. If you don't use
  168. the installation program or you need to copy one of the original
  169. files onto your hard disk, use the EXTRACT.EXE utility located on
  170. the diskette and in your EW directory.
  171.  
  172.   Command        Description
  173.   ~~~~~~~        ~~~~~~~~~~~
  174.   /U[:DESTINATION]  Unpack files to destination.
  175.   /L:ARCHIVE        List files in archive.
  176.   /Q            Quiet mode - only error messages are displayed.
  177.   /?            Display this message.
  178.  
  179.   Wildcards are permitted. Brackets, "[ ]", specify optional items. You
  180.   don't need to specify a destination filename because it's already
  181.   contained in the archive file.
  182.  
  183.  
  184. 2. DISK VENDORS
  185.  
  186. Please read VENDOR.TXT.
  187.  
  188. Please also read the Licence Agreement. Disk Vendors may not charge
  189. more than $5 (or its equivalent in local currency) for a diskette
  190. containing the installation files of E! for Windows. Also, E! for
  191. Windows may not be distributed on diskettes containing other
  192. products unless instructions are given describing how to build an
  193. installation diskette from the distributed disk.
  194.  
  195. Any vendor willing to market and distribute E! in its own country
  196. should contact
  197.  
  198.      Juergen Egeling Computer
  199.      Werderstr. 41, 76137 Karlsruhe, Germany.
  200.      Tel: +49 (0721) 373832
  201.      Fax: +49 (0721) 373842
  202.  
  203.  
  204. 3. DISTRIBUTION AND SUPPORT
  205.  
  206. Distribution, Registration and Hot Line are also managed by JEC
  207. in Europe.
  208.  
  209.      Juergen Egeling Computer
  210.      Werderstr. 41, 76137 Karlsruhe, Germany.
  211.      Tel: +49 (0721) 373832
  212.      Fax: +49 (0721) 373842
  213.      BBS: +49 (0) 721 37 46 25 2400-19200 8N1 24h
  214.       Official EW BBS. Newest Version online!
  215.      email: fft@jecalpha.ka.sub.org
  216.  
  217. In the USA please get in touch with
  218.  
  219.      HomeBrew Software
  220.      807 Davis Street
  221.      Suite E
  222.      Vacaville, CA 95687
  223.      (707) 451-9653  Voice
  224.      (707) 451-2500  FAX
  225.  
  226. In France please contact
  227.  
  228.      MainSoft sarl
  229.      15, avenue des Pres Pierre
  230.      91210 Draveil
  231.      Tel: +33 1 69 40 94 85
  232.      Fax: +33 1 69 40 94 85
  233.      e-mail: CIS 72561,3532
  234.          72561.3532@compuserve.com
  235.  
  236. Currently the software is only available in English while the
  237. documentation is available in English, French and German.
  238.  
  239. In the near future, we may release fully localized versions. In
  240. particular, we may experiment a full French version rather quickly (if we
  241. have enough registrations in french speaking countries). Specific
  242. problems related to the french language will be handled by MainSoft
  243. directly. Please get in touch with us if you have special needs in this
  244. area.
  245.  
  246. If you are interested in participating in the localization of E! for your
  247. own country, please get also in touch with us. We have designed E! in
  248. such a way that resources are in a separate DLL. So, localization should
  249. be rather easy.
  250.  
  251.  
  252. 4. IMPORTANT CHANGES SINCE LAST DOCUMENTATION UPDATE
  253.  
  254. Please see MOREDOC.TXT
  255.  
  256.  
  257. 5. ORDERING / REGISTERING ONLINE
  258.  
  259. If you have a Compuserve account, online registration is possible. GO
  260. SWREG and use program id #586. You'll receive your registration code
  261. within two days by e-mail and the printed documentation by mail.
  262.  
  263. Otherwise, please fill in the registration form (ORDER.FRM) and mail
  264. it or fax it to one of the mailing addresses mentioned below. We can't
  265. manage upgrades through SWREG, sorry.
  266.  
  267. You can also register online by calling the JEC BBS. See below.
  268.  
  269. If you have made a first installation, the Order Form can be loaded
  270. from the User Menu.
  271.  
  272.  
  273. 6. TECHNICAL NOTES
  274.  
  275. Technical notes will give you immediate information about specific
  276. problems arising when using E! in certain environments or in
  277. conjunction with other programs like compilers. Technical Notes are
  278. distributed with the full package or the upgrade packages.
  279.  
  280.  
  281. 7. UPDATES
  282.  
  283. Information about updates can be obtained from the above mentioned
  284. FAX number.
  285.  
  286. Updates or fixes may be distributed as patches. We distribute a copy
  287. of Pocket Soft's PATCH.EXE (the program used to apply these patches)
  288. with the full package. We will NOT upload PATCH.EXE along with the
  289. patches themselves. Please keep PATCH.EXE in a safe place to be able
  290. to use it when necessary.
  291.  
  292.  
  293. 8. UPGRADING FROM E! 1.xx
  294.  
  295. There are changes in E! 2.0 that you must consider before installing:
  296.  
  297. 8.1 In order to support big files, we had to make some changes to
  298. the API. EWD files compiled for EW 1.xx are not compatible with E!
  299. 2.0 and you should not try to use them. We provide replacement files
  300. for the sample EWDs. Your own Extension DLLs just have to be
  301. recompiled using the new include file (EWAPI2.H) or the new import
  302. unit (EWAPIMP2.PAS). That's all. So, we recommend that you do not
  303. autoload EWDs until they have been recompiled.
  304.  
  305.  
  306. 8.2 The installation program will automatically translate your
  307. existing associations to the new layout in EW.INI. However, if you
  308. are using alternate .INI files you'll have to convert the
  309. associations manually. Dont' worry, it's easy. Associations were
  310. defined in the [system] section. They are now located in the
  311. [associations] section.
  312.  
  313. In version 1.xx the layout of each association entry was as follows:
  314.  
  315.   ext=Keyboard Menu CompilerSet ExpansionSet LoadMethod SaveMethod
  316.  
  317. The new layout of version 2.0 is as follows:
  318.  
  319.   ext=Keyboard Menu ExpansionSet LoadMethod SaveMethod HDFName
  320.  
  321. Associations between filename extensions and Compiler Command Sets
  322. are now useless and no longer exist. HDFName is the name of the
  323. Highlighting Definition File that should be used with files having
  324. the "ext" extension.
  325.  
  326. So, you only have to delete the third token in each existing
  327. association entry. Use the Associations Dialog Box to add the
  328. HDFName if necessary or add it directly if you want.
  329.  
  330. 8.3 The installation program will also add default filters.
  331. ([filters] section) to EW.INI. You can copy this information to your
  332. alternate .INI files if necessary.
  333.  
  334. 8.4 It is no longer necessary to add the \EW and \EW\USER directories
  335. to your PATH, provided you leave all DLLs and EWX.EXE in the \EW
  336. directory. The Extension DLLs (.EWD) must reside in your USER
  337. directory.
  338.  
  339.  
  340. 9. SAMPLE EXTENSION DLLs
  341.  
  342. We provide various sample Extension DLLs with E!. Although you do
  343. not have access to the API documentation in this shareware version,
  344. you can however use Extension DLLs (EWDs). These DLLs are used to
  345. provide additional functions to E! or to modify the built-in behavior
  346. of E!. All Sample DLLs (except VCHOOK) are provided with source code,
  347. either in Pascal or in C. The documentation for each EWD is provided
  348. in the source file. Here is a list of all provided EWDs:
  349.  
  350.     ansioem.ewd      An ANSI/OEM Conversion Tool
  351.     beginend.ewd     An Extension to the Search Matching Brace
  352.              function for the Pascal language
  353.     clearini.ewd     A simple way to clear Local Options
  354.     counter.ewd      A sample DLLs counting words and character in
  355.              the current text.
  356.     vchook.ewd         A gateway between E! and Visual C++ Workbench.
  357.     mulhelp.ewd      Two EWDs to support multiple help files.
  358.     mulhelp2.ewd
  359.     backtab.ewd      An extension to the Tab function.
  360.     selword.ewd      A sample EWD showing how to create a new
  361.              function.
  362.     localopt.ewd     A sample EWD showing how to modify Local
  363.              Options
  364.     toglcase.ewd     A handy function inverting the case of all
  365.              characters in the current word.
  366.     ewfext.ewd         A File Manager Extension DLL.
  367.  
  368. You are encouraged to write your own EWDs. With the E! API you can
  369. write sophisticated EWDs which could be sold as a package dedicated
  370. to the support of any language or environment. There are no
  371. royalties bound to the distribution of packages based on the E! API.
  372.  
  373.  
  374. 10. CREDITS
  375.  
  376. People who helped in this new project are mentioned in the "Credits"
  377. dialog box (Help Menu). Many thanks to all of them.
  378.  
  379.  
  380. 11. About MainSoft sarl
  381.  
  382. MainSoft is a french software company created by Patrick Philippot,
  383. the author of this software. MainSoft specializes in Windows
  384. software development, consulting and technical support to
  385. developers. We also have some experience in software localization
  386. (french). You can get in touch with us at the following address:
  387.  
  388.    MainSoft sarl
  389.    15, avenue des Pres Pierre
  390.    91210 Draveil
  391.    France
  392.    tel/fax: +33 1 69 40 94 85
  393.  
  394. Currently, the distribution of EW is managed in the USA and Canada by
  395.  
  396.            HomeBrew Software
  397.            807 Davis Street
  398.            Suite E
  399.            Vacaville, CA 95687
  400.            (707) 451-9653  Voice
  401.            (707) 451-2500  FAX
  402.  
  403. by Juergen Egeling Computer (for other countries with exception of France)
  404.  
  405.            Juergen Egeling Computer
  406.            Werderstr. 41, 76137 Karlsruhe, Germany.
  407.            Tel: +49 (0721) 373832 / Fax: +49 (0721) 373842
  408.            email: fft@jecalpha.ka.sub.org
  409.  
  410.  
  411. 12. WHERE CAN I GET THE LATEST VERSION OF E!?
  412.  
  413. If you don't have a Compuserve account, you can dowload the newest
  414. version of E! for Windows from the following servers:
  415.  
  416. Germany:       JEC BBS (area EW20)
  417.            +49 721 37 46 25 (19200 and less, N,8,1)
  418.            24h a day
  419.  
  420. You can use this BBS to register online, ask for support or talk
  421. with other EW users.
  422.  
  423.                 OR
  424.  
  425. Internet:       FTP : OAK.OAKLAND.EDU (141.210.10.117)
  426.              /pub/msdos/windows3
  427.  
  428.                 OR
  429.  
  430. USA:              Software Creations
  431.         1200/2400 V.42/MNP Lines : (508) 365-2359
  432.         2400-14.4k HST US Robotics Lines : (508) 368-7036
  433.     2400-16.8k V.32/V.42bis US Robotics lines : (508) 368-7139
  434.      14.4-28.8k V.32/V.42bis/V.fc Hayes Optima lines: (508) 365-9352
  435.  14.4-28.8k V.32/V.42bis/V.32terbo/V.fc US Robotics lines: (508) 368-3424
  436.  
  437.